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Abstract : 


While building or understanding large LISP systems, many small 
auxiliary functions . are.. often . subject. to . errors or 
misunderstanding, in the case of very involved recursions. 
RAINBOW is a specialized program understanding system able to 
reduce automatically such sets of recursive functions to a form 
where the goal of these sets are clearly displayed. RAINBOW can 
display interactively the goal-forms into two sets of new 
external 2-dimensional notations: recursive and Linear. Program 
understanding is obtained by the translation of the original set 
of LISP functions into the open recursive notation, then by 
elementary symbolic evaluation yielding closed linear forms of 
the original functions. Those Linear forms are exactly the goals 
wanted. RAINBOW operates efficiently on a definite class of LISP 
functions, and uses an extendable set of reduction rules, which 
constitute the symbolic interpreter. RAINBOW can be used 
interactively if a user want to verify that a set of functions 
perform its intended goal, or can be incorporated easily as a 
specialized component of a larger program understanding system. 
This paper shows how RAINBOW operates on sets of recursive 
functions building combinatorial objects. 
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1. INTRODUCTION 


RAINBOW is a specialized interactive program understanding system. It asks from its 
user a set of recursive functions definitions, then extracts and displays graphicaliy 
its goal, in terms of properties of Lists viewed as sequences. 


To display the goal of a definition set, we have introduced two classes of 
é2-dimensional external notations which are implemented within RAINBOW. The open 
notation is a compact notation for recursive programs or data structures, the closed 
notation expresses intrinsic properties of Linear sequences in term of generic 
properties of their elements. 


Program understanding is obtained by the translation of the original set of functions 
into the open notation, then by elementary symbolic evaluation yielding closed forms 
of the original functions. The closed forms are exactly the goals wanted. 


Presently, RAINBOW can reason about classes of data-structures as Lists considered as 
sequences, extensions to recursive LISP functions operating on other classes of 
data-structures are considered. 


RAINBOW can be used either as a front-end of a LISP system, or as a specialized part 
for low-level understanding of sequences, in a larger program understanding system. 
An analogy with low-level machine vision is here in order: scene analysis has to 
rely upon intrinsic properties of pictures, as incidence, gradient, illumination or 
texture. We believe that a large program understanding system must also rely upon 
intrinsic properties of the data involved in the programs tentatively analyzed. 


À programming apprentice system (RICH 1979, WERTZ 1979), if used interactively, must 
have the capability of focusing in a visually understandable way, to lower levels of 
plans. The plans diagrams described in (SHROBE 1979) seem promising either at very 
high level of inter-module analysis, or when the goal of a module is intermixed with 
other goals, or when global side-effects are involved. However these plans, 
displaying very well the global course of actions involved in analysed programs, do 
not seem appropriate to be used for lower-level modules because they do not allow to 
display the structure of the elementary goals for simple modules. Unfortunately, in 
very large systems, it seems that the simplest modules are the most. error-prone. 


RAINBOW allows the user to check. immediately, in a visually understandable way, the 
goal of a set of functions definitions. The user does not have to provide an 
assertion to verify ,about his definitions set, because in a sense RAINBOW is 
precisely reducing this set to its assertion. 


RAINBOW is an implemented system written in [LISP] (CHAILLOUX 1978) running on DEC 
KI-10, and PDP 11/40. The external notations can be visualized on any kind of 
display or hard-copy terminal. 


2. QUERVIEW OF THE RAINSOW SYSTEM 
The symbolic interpreter: 


The symbolic interpreter is essentially a production system having an initial fixed 
set of reduction rules for the handling of LISP sequences. When a user submits a new 
function definition to RAINBOW, the reduced closed linear form obtained as a goal is 
incorporated by the system into the set of rutes. The interpreter is able to expand 
every inner function call with the replacement part of the corresponding rule along 
with the renaming of variables when necessary (d-conversion). As in (BOYER 1977), 
The interpreter operates iteratively until no more rule can apply to the reduced 
form. 


The definitions entered can be also called within the LISP iterpreter, and every step 
of. the reduction can be interactively reversed, providing an history of the 
reduction. Also at user-level, RAINBOW can handle symbolic function calls. 


The process of resolution into linear forms uses a set of reduction rules for the 
translation of recursive representations into linear representations. 


The reduction set of rules for a LISP function is expressed into two new classes of 
graphical notations for recursive programs and data, and for linear sequences. 


Recursive and linear external notations: 
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It is used to express generic 
expresses characteristics of sequences. 


Li Eil Sar (Œ 


context of RAINBOW, the range 


EXAMPLES: 


(CAR 


(CDR 


(CONS E: 


(REVERSE 


n i-i 
| | 
Ci Ej Lj 
o] 
1 1 


immediately following it. 


n 1 
| | 
fi E,]> re ft 
| | 
1 n 


n 


Be 


1 Eg «ee Ep) 


of the index variable ts 


A more complex example is: 


| 
(CONS ALi) kKLe]] oF 
| 


i+] 
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results or goals of the analysed 


The letter 7 is an “index variable" ranging from lower to upper indices, here from 1 
| to n. When one of the indices is 0, 


the 


functions: Lt 


This notation is a 2-dimensional specialization of the one used in (GOOSSENS 1979). 


the notation denotes the empty sequence. In the 


LISP expression 


(CONS A Ly)]] 
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2) recursive 


It is used to express the recursive computation performed by the function. Tt has 
the general form: 


n 

| | 7 

ai - Bi a =df Ql s.. On ð Gy... Bi 
1 


where ai, i, and ð are parts of LISP expressions as well as Linear or recursive 
forms. The recursive notation is essentially an indexed context-free grammar rule. 
It expresses n levels of nesting of function calls terminating with the expression ð, 
When the RAINBOW system uses the recursive notation, n is the Length of the List 
Which is the value of the recursion variable. The crossing of lines in the notation 
denotes a self-reference to the entire expression with the index variable progressing 
one step towards the highest index. | 


As an example RAINBOW translates interactively, the following function definition 
(DE append (Xx Y) 
CIF (NULL X) Y 
(CONS (CAR X) | 
(append (CDR X) Y)))) 


into the recursive form 


| 
(CONS Xi -) Y 


Fe eet (nt es 5 


which schematizes the nested expression 


(CONS X, (CONS Xz... (CONS Xn Y) ... )) 


where Xı translates (CAR (CDR X)) 
n 
Lj Xil translates X 
i 
n 
nl Xi] translates (CDR X) 
a 


It happens that the goal of the append function is itself expressed into the 
reduction rute RC2: 


pe ga e T 


m n m 
| | | | 
(CONS Xi - ) [j Yj] EP Ci Xi j Yul 
I | | 
1 1 1 
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3. USING RAINSOW: A SIMPLE REDUCTION 


RAINBOW can be used interactively for the automatic documentation of programs 
as soon as they are typed, as advocated by (WINOGRAD 1979). In the following 
example, RAINBOW is reducing to its goal a set of two simple recursive functtons. 


The user types the following definitions 
(DE f (X Y) 
CIF (NULL X%) NIL 


(APPEND (g (CAR X) Y) 
(f (CDR X) Y)))) 


that BAINBOW translates immediately into 


7 | 
(APPEND (g Xi W -) NIL 


PI perme J 


then the following definition 


(DE g (A Y) 
CIF (NULL Y> NIL 
(CONS (LIST A (CAR Y)) 
(g A (CDR Y))))) 


is translated into 


| 
(CONS [A Yi] -) NIL 


pdm pre ZJ 


then the user types to RAINBOW the symbolic call 
(f (xlistx A) (xlistx B)) 


which is reduced into the linear form 


| m 
| 
[i j fAi Bill] 
|] 
11 


which yields the goal of the function f: 
f builds the cartesian product of its two argument-lists. 
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The reduction set of rules which has been used in the previous example is: 
~ the definition of the function g itself. 


- the rule RCI: 


Pde pe mF 


n 
| | 
(CONS E: - ) NIL KP [i E] 
| 
1 


- the rule RAL: 


oe 


n 

| | , 

i (APPEND «i -) NL p 
| 

1 


ro 
formed arasas came mme a | 


So the RAINBOW system yields in succession : 
? (Cf Gklist* A) Gslistx Bd) 


Lines beginning with "?" are typed directly by the user 


n 
| m | 
(APPEND <G A; r Bj1) L NIL 
e 
OK 

? ap all 


a 
APPLYING... G GIVING... 
| aaa | 


n 

| | | 

i (APPEND j (CONS IA; Bj] -) NIL -) NIL 
| | ll de 


APPLYING... RC1 GIVING... 


n 

| m | 

(APPEND rl LA: Bjl] L, NIL 

S 
APPLYING... RA1 GIVING... 


il 

| 

Li j (TA, Bil] The Final linear form 
| | 

1 1 
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4, UNDERSTANDING COMPLEX RECURSIONS 


Sometimes recursion can be quite involved, as in the following square 
generator: 


(DE vecmat (Œ) 
CIF (NULL E) NIL 
(CONS E 
(DCONS (CAR E) (vecmat (CDR E)))))) 


where 
n n 
| | 
(DCONS « [i ED KFP [i (CONS « E,)] 
| | 
1 1 
The goal of VECMAT extracted by RAINBOW is: 
n non 
| | | 
(VECMAT o Eid) = i Li Eill 
| 
1 | 1 1 


The body of VECMAT is slightly generalized to obtain the main reduction rule: 


Oo 
1 | | TRE | 
i (CONS &i (DCONS E, - )) NIL | a (CONS j (CONS Ej i ) ri = ) NIL 
| —_ | i 
i 1 1 


which by the rule RC1 is reduced itself to: 


1 


t 
| | 
= Ci j (CONS E; -) w& (rute RDC4) 
|. or 3 
1 


P a 


n 
| 

Now if we sets a; to [k Ex], RAINBOW obtains the linear form for VECMAT by: 
| | 
i 


1 n n i n n n 
| ; | 
E; k Ekl]? we [i Cj E;l] 
a | S 4 
L i 1 


1 


E | 1 | 
E 

Fi į (CONS E; -) Ik Ex]] F fi Cj 
| | 
1 1 i 1 


The final result being obtained by the reduction rule RIND2: 


i-l n n 

| | | 

[i Xi l Xj] EFP i Xil 
| 

1 i 1 
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ho 


The same reduction process can be used to obtain the goal of the function partinsert, 
main component of a recursive partition generator. Though very usual this style of 


recursion is ratner difficult to visualize, and is very error-prone. 
example displays a session with RAINBOW: 


The user types the definition 
? (DE partinsert (X E) 
CIF (NULL E) NIL 


(CONS (CONS (CONS X (CAR E)) (CDR E)) 
(DCONS (CAR E) (partinsert X (CDR £)))))) 


hat RAINBOY translates into 
n | 


| | 
(LAMBDA (X E) (CONS [(CONS X E,) j Eg] (DCONS E; -)) NIL) 
| 


t 
n 
| 
| 
L 
| — 
1 i+] 

Then the user provides the symbolic call 


? cl (partinsert A Gxlistx L)) 


n | 
7 
(CONS [CCONS A Lid j Lyi (CONS L; -)) NIL 
1 | i+] — 
Then the user asks for all reduction rules 
to be applied 
? ap all 


a 
APPLYING... RDC4 GIVING... 


i-1 n | 


— | 


n 

| | P| 

i (CONS j (CONS L; -) [(CONS A Li) k Lx] -) NIL 
| | 

1 


i+] 


APPLYING... RC1 GIVING... 


n i-l n 

| | | | 
Ci j (CONS L; -—) ECCCONS A L:i) k LklIl 
| | — | 

1 1 itl 


APPLYING... RC2 GIVING... 


n i-l n 
l | L; (CONS A Li) : Lk] 
| i la 
OK 


The Final reduced form is the goal of partinsert 


http://www.artinfo-musinfo.org Rapport ATP 4273, octobre 1980, page 51 / 124 


5. CONCLUSION 


The 2-dimensional display for formula within RAINBOW is claimed to be intuitively 


understandable by using intrinsic properties of sequences: the use of indices 
relates the length and order of the sequence to the general form of the generic 
elements. 


Along with the powerful reductions from recursive to Linear forms, we believe that 
the external notations presented here reflect our intuitive understanding of lists 
and their properties. 


In a fast checking situation, this graphical style of verification, displaying thea 
generic structure of data, gives the user excellent control over the goal obtained 
from a functions seis. 


The extendability provided by the incorporation of every new function definition as a 
new reduction rule in the spirit of (BOYER 1977) gives a useful tool to system design 
and programming methodology: as advocated by (GERHART 1975), the resulting schema 
and transformations that are saved will have to be ultimately organized into 
"handbooks of knowledge" about programming. 


Presently, RAINGOW is able to reason about classes of data structures as sequences, 
we are considering tts extension to arrays using the rules given in (REYNOLDS 1979). 
Program understanding with RAINBOW can be viewed as a kind of simplification, and its 
extension to several classes of data-structures may involve combination of decision 
procedures for several theories described in (NELSON 1978), (OPPEN 1978). 


Internally, RAINBOW is mainly driven, out of the fixed initial set, by user-provided 
rules obtatned by reduction of previous definitions to their goals. Thus, the power 
of RAINBOW is strictly limited by the class of expressions that the external 
notations are able to denote. Most of the rules in the fixed initial set are 
properties of the function CONS, extended to APPEND and REVERSE. 


In the present state of the rules, RAINBOW is restricted to primitive recursive 
functions. A single recursion variable is handled within each rule: an obvious 
extension to an arbitrary number of recursion variables can be incorporated, each 
having the same pattern of sequence as an argument. 


Another extension is currently implemented to handle iterative function schema as in: 


(DE itrev (X Y) 
CIF (NULL X) Y 
Citrevy (CDR X) (CONS (CAR X) Y¥)))) 


where Y is acting as an accumulator. With such an extension, the translation of 
trev into the recursive notation should be: 


| 
i (CONS X: yy 
| 4 


n 
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With this extension, checking of equivalences as: 


(APPEND X Y) = Citrev Citrev X NIL) Y) 


could be done by direct reduction as in: 


5. 


[1] 


[2] 


[3] . 


[4] 


[5] 


[6] 


[7] 


[8] 


[9] 


n m n m 
| | | 
(APPEND [i Xi] D YD ER Citrev (trev [i Xi] NID Ij YD 
| | | | 
1 1 1 1 


1 m 
| 
KP (itrev [i- Xi] [j Y;]l) 
| | 
n 1 
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